home *** CD-ROM | disk | FTP | other *** search
/ Internet Warrior 1993 July / Internet Warrior No. 1 July 1993 - Austin Code Works.ISO / docs / tools / wais / waisinde.txt < prev    next >
Encoding:
Text File  |  1992-08-24  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. WAISINDEX(1)             USER COMMANDS               WAISINDEX(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      waisindex - Indexes files
  10.  
  11. SYNOPSIS
  12.      waisindex      [ -d index_filename ]      [ -a ]      [ -r ]
  13.      [ -mem mbytes ]    [ -register ]   [ -t type ]   [ -export ]
  14.      [ -nocat ] filename filename ...
  15.  
  16. DESCRIPTION
  17.      waisindex creates an index of the words  in  files  so  that
  18.      they  can  be  searched quickly (see waissearch).  The index
  19.      takes about as much disk space as  the  original  text.   It
  20.      also creates a new source structure named index_filename.src
  21.      if none exists.
  22.  
  23. OPTIONS
  24.      -d index_filename
  25.                This is the base filename  for  the  index  files.
  26.                Therefore if /usr/local/foo is specified, then the
  27.                index files will be called /usr/local/foo.dct etc.
  28.                The index should be stored on the local file  sys-
  29.                tem  of  the  machine running waisindex.  It works
  30.                over NFS, but it is much slower.
  31.  
  32.      -a        Append this index to an existing one.  Useful  for
  33.                incremental  additions or updates.  This will only
  34.                add onto an index, so that if a file has  changed,
  35.                it  will  get  reindexed, but the old entries will
  36.                not be purged.  Therefore, to save space, it is  a
  37.                good  idea  to  reindex  the  whole  set  of files
  38.                periodically.
  39.  
  40.      -r        Recursively index subdirectories.
  41.  
  42.      -mem      How much main memory to use during indexing.  This
  43.                variable  will  have  a  large  effect on how fast
  44.                indexing is done.
  45.  
  46.      -register Register  this  database  with  the  directory  of
  47.                servers.   You  are  encouraged  to register data-
  48.                bases, but only ones  that  will  be  consistently
  49.                running.  The directory of servers is available to
  50.                anyone that is on the internet or can phone in.
  51.  
  52.      -t type   This is the format of files that  are  handled  by
  53.                waisindex.   It  is easy to parse a different for-
  54.                mat, but that has  to  be  done  by  changing  the
  55.                source  (ircfiles.c).   To  find  out  the list of
  56.                currently known types, execute the waisindex  com-
  57.                mand with no arguments and it will list them.
  58.  
  59.      -export   This causes the resulting source description  file
  60.  
  61.  
  62.  
  63. Thinking Machines Last change: Thu Feb 20 1992                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. WAISINDEX(1)             USER COMMANDS               WAISINDEX(1)
  71.  
  72.  
  73.  
  74.                to  include  the host-name and tcp-port for use by
  75.                the clients.  Otherwise the file contains no  con-
  76.                nection  information,  and  is expected to be used
  77.                only for local searches.
  78.  
  79.      -nocat    Inhibits the creation of a catalog.  This is  use-
  80.                ful  for  databases  with  a large number of docu-
  81.                ments, as the catalog contains 3 lines  per  docu-
  82.                ment.
  83.  
  84.      filename filename...
  85.                These are the files that will be indexed according
  86.                to  the  arguments above.  To insure the files are
  87.                registered in the filename table correctly, it  is
  88.                advised that these be full paths (beginning with a
  89.                /).  If the database is to be used from a  machine
  90.                other  than  the  machine  on  which  the index is
  91.                created,  this  should  be  a  machine-independant
  92.                path.
  93.  
  94.  
  95. SEE ALSO
  96.      waissearch(1), waisserver(1), waissearch-gmacs(1), xwais(1),
  97.      xwaisq(1)
  98.  
  99.      Wide Area Information Servers Concepts by Brewster Kahle.
  100.      Brewster@think.com
  101.  
  102.  
  103. DIAGNOSTICS
  104.      The diagnostics produced by the waisindex are  meant  to  be
  105.      self-explanatory.
  106.  
  107.  
  108. BUGS
  109.      It temporarily takes twice the space it needs for an index.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Thinking Machines Last change: Thu Feb 20 1992                  2
  130.  
  131.  
  132.  
  133.